Skip to content

docs: clarify fakemachine runtime environment#308

Open
obbardc wants to merge 2 commits into
mainfrom
wip/obbardc/readme-add-intended-use
Open

docs: clarify fakemachine runtime environment#308
obbardc wants to merge 2 commits into
mainfrom
wip/obbardc/readme-add-intended-use

Conversation

@obbardc
Copy link
Copy Markdown
Member

@obbardc obbardc commented May 3, 2026

Clarify what is meant by creating a VM from the "currently running system". The phrase refers to the environment fakemachine is invoked from: this may be a host system, container or CI runner.

Expand the README to describe that fakemachine is mainly used by debos to execute actions inside a VM derived from the current runtime environment. Also clarify that container usage is common but not required and that KVM is optional for acceleration rather than a hard dependency.

Closes: #303

Comment thread doc/man/fakemachine.1 Outdated
Comment thread doc/man/fakemachine.1 Outdated
obbardc added 2 commits May 11, 2026 09:33
Clarify that fakemachine creates a VM using the current root filesystem
rather than constructing a separate one.

This may be the host root filesystem or, when fakemachine is run inside
a container, the container root filesystem.

Closes: #303
Signed-off-by: Christopher Obbard <christopher.obbard@linaro.org>
Signed-off-by: Christopher Obbard <christopher.obbard@linaro.org>
@obbardc obbardc force-pushed the wip/obbardc/readme-add-intended-use branch from 176adb8 to fbceecd Compare May 11, 2026 08:33
@obbardc obbardc requested a review from sjoerdsimons May 11, 2026 08:33
@bitsondatadev
Copy link
Copy Markdown

@obbardc sorry it took me a minute. This all reads clearly to me now. No notes! :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Clarify the intended use of fakemachine

3 participants